Node / meshtastic / Meshtastic-Android / files / feature / docs / src / commonTest / kotlin / org / meshtastic / feature / docs / translation / TranslationCascadeTest.kt

Displaying Raw • Download

T8b949e/*

* Copyright (c) 2026 Meshtastic LLC

*

* This program is free software: you can redistribute it and/or modify

* it under the terms of the GNU General Public License as published by

* the Free Software Foundation, either version 3 of the License, or

* (at your option) any later version.

*

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

* GNU General Public License for more details.

*

* You should have received a copy of the GNU General Public License

* along with this program. If not, see <https://www.gnu.org/licenses/>.

*/

Tff7b72package T7ee787org.meshtastic.feature.docs.translation

Tff7b72import T7ee787kotlinx.coroutines.test.runTest

Tff7b72import T7ee787kotlin.test.Test

Tff7b72import T7ee787kotlin.test.assertEquals

Tff7b72import T7ee787kotlin.test.assertIs

T8b949e/**

* Tests for the translation cascade decision logic: Crowdin bundled → ML Kit runtime → English fallback.

*

* These tests exercise the service interface contracts without ML Kit (which requires Android).

*/

Tff7b72class T56d364TranslationCascadeTest Tb4b4b4{

Tf0883e@Test

Tff7b72fun Td2a8ff`NoOp translator returns Unavailable for any locale`Tb4b4b4(Tb4b4b4) Tff7b72= Te6edf3runTest Tb4b4b4{

Tff7b72val Te6edf3serviceTb4b4b4: Te6edf3DocTranslationService Tff7b72= Te6edf3NoOpDocTranslatorTb4b4b4(Tb4b4b4)

Tff7b72val Te6edf3result Tff7b72= Te6edf3serviceTb4b4b4.Te6edf3translatePageTb4b4b4(Ta5d6ff"Ta5d6ffonboardingTa5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ff# HelloTa5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ffesTa5d6ff"Tb4b4b4)

Te6edf3assertIsTff7b72<Te6edf3TranslationResultTb4b4b4.Te6edf3UnavailableTff7b72>Tb4b4b4(Te6edf3resultTb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`NoOp translator reports language unavailable`Tb4b4b4(Tb4b4b4) Tff7b72= Te6edf3runTest Tb4b4b4{

Tff7b72val Te6edf3serviceTb4b4b4: Te6edf3DocTranslationService Tff7b72= Te6edf3NoOpDocTranslatorTb4b4b4(Tb4b4b4)

Te6edf3assertEqualsTb4b4b4(Tff7b72falseTb4b4b4, Te6edf3serviceTb4b4b4.Te6edf3isLanguageAvailableTb4b4b4(Ta5d6ff"Ta5d6ffesTa5d6ff"Tb4b4b4)Tb4b4b4)

Te6edf3assertEqualsTb4b4b4(Tff7b72falseTb4b4b4, Te6edf3serviceTb4b4b4.Te6edf3isLanguageAvailableTb4b4b4(Ta5d6ff"Ta5d6fffrTa5d6ff"Tb4b4b4)Tb4b4b4)

Te6edf3assertEqualsTb4b4b4(Tff7b72falseTb4b4b4, Te6edf3serviceTb4b4b4.Te6edf3isLanguageAvailableTb4b4b4(Ta5d6ff"Ta5d6ffzhTa5d6ff"Tb4b4b4)Tb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`NoOp translator download returns Failed`Tb4b4b4(Tb4b4b4) Tff7b72= Te6edf3runTest Tb4b4b4{

Tff7b72val Te6edf3serviceTb4b4b4: Te6edf3DocTranslationService Tff7b72= Te6edf3NoOpDocTranslatorTb4b4b4(Tb4b4b4)

Tff7b72val Te6edf3result Tff7b72= Te6edf3serviceTb4b4b4.Te6edf3downloadLanguageModelTb4b4b4(Ta5d6ff"Ta5d6ffesTa5d6ff"Tb4b4b4)

Te6edf3assertIsTff7b72<Te6edf3DownloadResultTb4b4b4.Te6edf3FailedTff7b72>Tb4b4b4(Te6edf3resultTb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`fake translator returns success with translated content`Tb4b4b4(Tb4b4b4) Tff7b72= Te6edf3runTest Tb4b4b4{

Tff7b72val Te6edf3service Tff7b72= Te6edf3FakeDocTranslatorTb4b4b4(Te6edf3translatedPrefix Tff7b72= Ta5d6ff"Ta5d6ff[ES] Ta5d6ff"Tb4b4b4)

Tff7b72val Te6edf3result Tff7b72= Te6edf3serviceTb4b4b4.Te6edf3translatePageTb4b4b4(Ta5d6ff"Ta5d6ffonboardingTa5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ff# HelloTa5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ffesTa5d6ff"Tb4b4b4)

Te6edf3assertIsTff7b72<Te6edf3TranslationResultTb4b4b4.Te6edf3SuccessTff7b72>Tb4b4b4(Te6edf3resultTb4b4b4)

Te6edf3assertEqualsTb4b4b4(Ta5d6ff"Ta5d6ff[ES] # HelloTa5d6ff"Tb4b4b4, Te6edf3resultTb4b4b4.Te6edf3translatedMarkdownTb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`fake translator returns ModelDownloadRequired when not downloaded`Tb4b4b4(Tb4b4b4) Tff7b72= Te6edf3runTest Tb4b4b4{

Tff7b72val Te6edf3service Tff7b72= Te6edf3FakeDocTranslatorTb4b4b4(Te6edf3isDownloaded Tff7b72= Tff7b72falseTb4b4b4)

Tff7b72val Te6edf3result Tff7b72= Te6edf3serviceTb4b4b4.Te6edf3translatePageTb4b4b4(Ta5d6ff"Ta5d6ffonboardingTa5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ff# HelloTa5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ffesTa5d6ff"Tb4b4b4)

Te6edf3assertIsTff7b72<Te6edf3TranslationResultTb4b4b4.Te6edf3ModelDownloadRequiredTff7b72>Tb4b4b4(Te6edf3resultTb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`fake translator returns Unavailable for unsupported locales`Tb4b4b4(Tb4b4b4) Tff7b72= Te6edf3runTest Tb4b4b4{

Tff7b72val Te6edf3service Tff7b72= Te6edf3FakeDocTranslatorTb4b4b4(Te6edf3supportedLocales Tff7b72= Te6edf3setOfTb4b4b4(Ta5d6ff"Ta5d6ffesTa5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6fffrTa5d6ff"Tb4b4b4)Tb4b4b4)

Tff7b72val Te6edf3result Tff7b72= Te6edf3serviceTb4b4b4.Te6edf3translatePageTb4b4b4(Ta5d6ff"Ta5d6ffonboardingTa5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ff# HelloTa5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ffxxTa5d6ff"Tb4b4b4)

Te6edf3assertIsTff7b72<Te6edf3TranslationResultTb4b4b4.Te6edf3UnavailableTff7b72>Tb4b4b4(Te6edf3resultTb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`cache hit avoids translation call`Tb4b4b4(Tb4b4b4) Tff7b72= Te6edf3runTest Tb4b4b4{

Tff7b72var Te6edf3translateCallCount Tff7b72= T79c0ff0

Tff7b72val Te6edf3service Tff7b72= Te6edf3FakeDocTranslatorTb4b4b4(Te6edf3translatedPrefix Tff7b72= Ta5d6ff"Ta5d6ff[ES] Ta5d6ff"Tb4b4b4, Te6edf3onTranslate Tff7b72= Tb4b4b4{ Te6edf3translateCallCountTff7b72+Tff7b72+ Tb4b4b4}Tb4b4b4)

T8b949e// First call — translator is invoked

Te6edf3serviceTb4b4b4.Te6edf3translatePageTb4b4b4(Ta5d6ff"Ta5d6ffpage1Ta5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ff# HelloTa5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ffesTa5d6ff"Tb4b4b4)

Te6edf3assertEqualsTb4b4b4(T79c0ff1Tb4b4b4, Te6edf3translateCallCountTb4b4b4)

T8b949e// Second call with same inputs — fake has no cache, so it calls again

T8b949e// (real MlKitDocTranslator has DocTranslationCache that would prevent this)

Te6edf3serviceTb4b4b4.Te6edf3translatePageTb4b4b4(Ta5d6ff"Ta5d6ffpage1Ta5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ff# HelloTa5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ffesTa5d6ff"Tb4b4b4)

Te6edf3assertEqualsTb4b4b4(T79c0ff2Tb4b4b4, Te6edf3translateCallCountTb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`TranslationResult sealed hierarchy covers all cases`Tb4b4b4(Tb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3successTb4b4b4: Te6edf3TranslationResult Tff7b72= Te6edf3TranslationResultTb4b4b4.Te6edf3SuccessTb4b4b4(Ta5d6ff"Ta5d6fftranslatedTa5d6ff"Tb4b4b4)

Tff7b72val Te6edf3downloadTb4b4b4: Te6edf3TranslationResult Tff7b72= Te6edf3TranslationResultTb4b4b4.Te6edf3ModelDownloadRequiredTb4b4b4(Ta5d6ff"Ta5d6ffesTa5d6ff"Tb4b4b4, T79c0ff3T79c0ff0Tb4b4b4)

Tff7b72val Te6edf3unavailableTb4b4b4: Te6edf3TranslationResult Tff7b72= Te6edf3TranslationResultTb4b4b4.Te6edf3Unavailable

Te6edf3assertIsTff7b72<Te6edf3TranslationResultTb4b4b4.Te6edf3SuccessTff7b72>Tb4b4b4(Te6edf3successTb4b4b4)

Te6edf3assertIsTff7b72<Te6edf3TranslationResultTb4b4b4.Te6edf3ModelDownloadRequiredTff7b72>Tb4b4b4(Te6edf3downloadTb4b4b4)

Te6edf3assertIsTff7b72<Te6edf3TranslationResultTb4b4b4.Te6edf3UnavailableTff7b72>Tb4b4b4(Te6edf3unavailableTb4b4b4)

Te6edf3assertEqualsTb4b4b4(Ta5d6ff"Ta5d6ffesTa5d6ff"Tb4b4b4, Tb4b4b4(Te6edf3download Tff7b72as Te6edf3TranslationResultTb4b4b4.Te6edf3ModelDownloadRequiredTb4b4b4)Tb4b4b4.Te6edf3localeTb4b4b4)

Tb4b4b4}

Tb4b4b4}

T8b949e/** Configurable fake for testing cascade behavior. */

Tff7b72private Tff7b72class T56d364FakeDocTranslatorTb4b4b4(

Tff7b72private Tff7b72val Te6edf3translatedPrefixTb4b4b4: Tffa657String Tff7b72= Ta5d6ff"Ta5d6ff[TRANSLATED] Ta5d6ff"Tb4b4b4,

Tff7b72private Tff7b72val Te6edf3isDownloadedTb4b4b4: Tffa657Boolean Tff7b72= Tff7b72trueTb4b4b4,

Tff7b72private Tff7b72val Te6edf3supportedLocalesTb4b4b4: Te6edf3SetTff7b72<Tffa657StringTff7b72> Tff7b72= Te6edf3setOfTb4b4b4(Ta5d6ff"Ta5d6ffesTa5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6fffrTa5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ffdeTa5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ffzhTa5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ffjaTa5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ffkoTa5d6ff"Tb4b4b4)Tb4b4b4,

Tff7b72private Tff7b72val Te6edf3onTranslateTb4b4b4: Tb4b4b4(Tb4b4b4) Tff7b72-Tff7b72> Tffa657Unit Tff7b72= Tb4b4b4{Tb4b4b4}Tb4b4b4,

Tb4b4b4) Tb4b4b4: Te6edf3DocTranslationService Tb4b4b4{

Tff7b72override Tff7b72suspend Tff7b72fun Td2a8fftranslatePageTb4b4b4(Te6edf3pageIdTb4b4b4: Tffa657StringTb4b4b4, Te6edf3markdownTb4b4b4: Tffa657StringTb4b4b4, Te6edf3targetLocaleTb4b4b4: Tffa657StringTb4b4b4)Tb4b4b4: Te6edf3TranslationResult Tb4b4b4{

Tff7b72if Tb4b4b4(Te6edf3targetLocale Tff7b72!in Te6edf3supportedLocalesTb4b4b4) Tff7b72return Te6edf3TranslationResultTb4b4b4.Te6edf3Unavailable

Tff7b72if Tb4b4b4(Tff7b72!Te6edf3isDownloadedTb4b4b4) Tff7b72return Te6edf3TranslationResultTb4b4b4.Te6edf3ModelDownloadRequiredTb4b4b4(Te6edf3targetLocaleTb4b4b4, T79c0ff3T79c0ff0Tb4b4b4)

Te6edf3onTranslateTb4b4b4(Tb4b4b4)

Tff7b72return Te6edf3TranslationResultTb4b4b4.Te6edf3SuccessTb4b4b4(Ta5d6ff"Tffd700$Te6edf3translatedPrefixTffd700$Te6edf3markdownTa5d6ff"Tb4b4b4)

Tb4b4b4}

Tff7b72override Tff7b72suspend Tff7b72fun Td2a8ffisLanguageAvailableTb4b4b4(Te6edf3localeTb4b4b4: Tffa657StringTb4b4b4)Tb4b4b4: Tffa657Boolean Tff7b72= Te6edf3locale Tff7b72in Te6edf3supportedLocales Tff7b72&Tff7b72& Te6edf3isDownloaded

Tff7b72override Tff7b72suspend Tff7b72fun Td2a8ffdownloadLanguageModelTb4b4b4(Te6edf3localeTb4b4b4: Tffa657StringTb4b4b4)Tb4b4b4: Te6edf3DownloadResult Tff7b72=

Tff7b72if Tb4b4b4(Te6edf3locale Tff7b72in Te6edf3supportedLocalesTb4b4b4) Te6edf3DownloadResultTb4b4b4.Te6edf3Success Tff7b72else Te6edf3DownloadResultTb4b4b4.Te6edf3FailedTb4b4b4(Ta5d6ff"Ta5d6ffUnsupported: Tffd700$Te6edf3localeTa5d6ff"Tb4b4b4)

Tb4b4b4}